OLA 文档中心

主题

2026-06-10

查找图片3 - FindImageFromPtrAll ​

函数简介 ​

在指定图片中查找指定图像的所有匹配位置，源图与模板均通过内存指针传入，返回全部匹配结果。

接口名称 ​

FindImageFromPtrAll

DLL调用 ​

long FindImageFromPtrAll(long instance, long source, long templ, string deltaColor, double matchVal);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
source长整数型OLAImage对象的地址（源图片）
templ长整数型OLAImage对象的地址（模板图片），由LoadImage等接口生成
deltaColor字符串颜色差值，格式为"RRGGBB"，如"101010"
matchVal双精度浮点数相似度，如0.85，最大为1

示例 ​

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long imgPtr = ola.LoadImage("images/scene.png");
long templPtr = ola.LoadImage("img/template.bmp");
if (imgPtr != 0 && templPtr != 0) {
    auto results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9);
    if (!results.empty() && results[0].MatchState) {
        int x = results[0].X;
        int y = results[0].Y;
    }
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr);
    ola.FreeImage(templPtr);
}
csharp
using OLAPlug;

var ola = new OLAPlugServer();
long imgPtr = ola.LoadImage("images/scene.png");
long templPtr = ola.LoadImage("img/template.bmp");
if (imgPtr != 0 && templPtr != 0)
{
    var results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9);
    if (results.Count > 0 && results[0].MatchState)
    {
        int x = results[0].X;
        int y = results[0].Y;
    }
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr);
    ola.FreeImage(templPtr);
}
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
img_ptr = ola.LoadImage("images/scene.png")
templ_ptr = ola.LoadImage("img/template.bmp")
if img_ptr and templ_ptr:
    results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9)
    if results and results[0].get("MatchState"):
        x = results[0]["X"]
        y = results[0]["Y"]
    # 后续不再使用该图时释放
    ola.FreeImage(img_ptr)
        # 后续不再使用该模板图时释放
    ola.FreeImage(templ_ptr)
java
import com.olaplug.OLAPlugServer;
import com.olaplug.model.MatchResult;
import java.util.List;

OLAPlugServer ola = new OLAPlugServer();
long imgPtr = ola.LoadImage("images/scene.png");
long templPtr = ola.LoadImage("img/template.bmp");
if (imgPtr != 0 && templPtr != 0) {
    List<MatchResult> results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9);
    if (results != null && !results.isEmpty() && results.get(0).MatchState) {
        int x = results.get(0).X;
        int y = results.get(0).Y;
    }
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr);
    ola.FreeImage(templPtr);
}
cpp
var ola = com("OlaPlug.OlaSoft")
var imgPtr = ola.LoadImage("images/scene.png")
var templPtr = ola.LoadImage("img/template.bmp")
if(imgPtr && templPtr) {
    var results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9)
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr)
    ola.FreeImage(templPtr)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
imgPtr = ola.LoadImage("images/scene.png")
templPtr = ola.LoadImage("img/template.bmp")
If imgPtr <> 0 And templPtr <> 0 Then
    results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9)
    ' 后续不再使用该图时释放
        ' 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr)
    ola.FreeImage(templPtr)
End If
text
.局部变量 ola, OLAPlug
ola.创建 ()
imgPtr ＝ ola.LoadImage ("images/scene.png")
templPtr ＝ ola.LoadImage ("img/template.bmp")
.如果真 (imgPtr ≠ 0 且 templPtr ≠ 0)
    results ＝ ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9)
    ' 后续不再使用该图时释放
    ola.FreeImage (imgPtr)
        ' 后续不再使用该模板图时释放
    ola.FreeImage (templPtr)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var imgPtr = ola.LoadImage("images/scene.png");
var templPtr = ola.LoadImage("img/template.bmp");
if(imgPtr && templPtr){
    var results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9);
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr);
    ola.FreeImage(templPtr);
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 imgPtr = ola.LoadImage("images/scene.png")
长整数 templPtr = ola.LoadImage("img/template.bmp")
如果真 (imgPtr ≠ 0 且 templPtr ≠ 0)
{
    MatchDataList results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9)
    ' 后续不再使用该图时释放
        ' 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr)
    ola.FreeImage(templPtr)
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
long imgPtr = ola.LoadImage("images/scene.png");
long templPtr = ola.LoadImage("img/template.bmp");
if (imgPtr != 0 && templPtr != 0) {
    auto results = ola.FindImageFromPtrAll(imgPtr, templPtr, "101010", 0.9);
    if (!results.empty() && results[0].MatchState) {
        int32_t x = results[0].X;
    }
    // 后续不再使用该图时释放
        // 后续不再使用该模板图时释放
    ola.FreeImage(imgPtr);
    ola.FreeImage(templPtr);
}

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long ptr = FindImageFromPtrAll(instance, imgPtr, templPtr, "101010", 0.9);
if (ptr != 0) {
    char json[8192] = {0};
    GetStringFromPtr(ptr, json, sizeof(json));
    int matchState = 0, x = 0, y = 0, width = 0, height = 0, index = 0;
    double matchVal = 0, angle = 0;
    ParseMatchImageAllJson(instance, json, 0, &matchState, &x, &y, &width, &height, &matchVal, &angle, &index);
    FreeStringPtr(instance, ptr);
}
csharp
using System.Runtime.InteropServices;
using System.Text;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringFromPtr(long ptr, StringBuilder lpString, int size);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int FreeStringPtr(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int GetStringSize(long ptr);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long FindImageFromPtrAll(long ola, long source, long templ, string deltaColor, double matchVal);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int ParseMatchImageAllJson(string str, int parseIndex, out int matchState, out int x, out int y, out int width, out int height, out double matchVal, out double angle, out int index);

long instance = CreateCOLAPlugInterFace();
long ptr = FindImageFromPtrAll(instance, imgPtr, templPtr, "101010", 0.9);
if (ptr != 0) {
    StringBuilder sb = new StringBuilder(GetStringSize(ptr) + 1);
    GetStringFromPtr(ptr, sb, sb.Capacity);
    FreeStringPtr(ptr);
    ParseMatchImageAllJson(sb.ToString(), 0, out int matchState, out int x, out int y, out int w, out int h, out double mv, out double ang, out int idx);
}
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
ptr = ola.FindImageFromPtrAll(instance, ...)
# 原生返回 JSON 数组指针，用 ParseMatchImageAllJson(instance, json, 0, ...) 取第一项

返回值 ​

字符串指针，返回JSON数组格式的所有匹配结果。DLL调用返回字符串指针地址，需要调用 FreeStringPtr 接口释放内存。

返回数据格式：

json
[{
    "MatchVal": 0.85,
    "MatchState": true,
    "Index": 0,
    "X": 100,
    "Y": 200,
    "Width": 100,
    "Height": 100
}]
字段名类型说明
MatchVal浮点数匹配相似度。
MatchState布尔是否匹配成功。
Index整数结果索引（从 0 开始）。
X整数X 坐标。
Y整数Y 坐标。
Width整数宽度。
Height整数高度。